SunSoft Catalyst CDWARE 1996 May to August

home *** CD-ROM | disk | FTP | other *** search

/ SunSoft Catalyst CDWARE 1996 May to August / Catalyst CDWARE 1996 May to August.iso / .products / IST / _demos / SparcSolaris / ISTSE.HELP.Z / ISTSE.HELP

Wrap

Text File | 1996-02-27 | 96KB | 2,674 lines

************************************************************ * * I N F O R M A T I O N S Y S T E M S * T E C H N O L O G I E S * * 13621 S.E. 19th St. * Bellevue, Washington 98005 * (206) 644-7441 * * Copyright 1987-1992 (c) All Rights Reserved. * * SysEdit Screen/Line Text Processor/Editor Revision 3.5.6 * ISTSE.HLP file * * It is important that this file is kept in sequence. The longest * panel names must be in front of others starting with the same chars * The format of the lines are as follows: * * LABEL lines start with a . in col 1 * * .[string1] string2 * * where string1 is the optional panel number * and string2 is the required panel name * * ENDPANEL lines start with a ~ in col 1 * * PANEL REFERENCES have a > in col 1 * * >[Next panel name or number] [optional display text] * * COMMENT LINES start with a * in col 1 * * PANEL DISPLAY LINES are all other lines * * This file should be located in /usr/local/IST and should * be named: ISTSE.HELP * ************************************************************ .0 ROOT ONLINE MANUAL AND HELP INDEX >1 FILE Commands to manipulate internal and external files >2 SEARCH Commands to search, locate and replace text >3 MODIFY Commands to modify lines, blocks and columns >4 CONFIG Commands to change SysEdit environment >5 DISPLAY Commands to display text and status information >6 CONTROL Commands to control SysEdit processing >7 HOW Information on HOW TO do normal editing tasks >8 WHAT SysEdit Glossary Information > (Default) Exit Help ~ .1 FILE FILE COMMANDS INDEX >e EDIT Start editing a new file >sa SAVe Save buffer to disk >fil FILe Save buffer to disk and end session >du DUnload Delete and place line(s) in an external file >loa LOAd Load lines from an external file >u UNload Line(s) to an external file >q Quit End session without saving >.. (Default) Return to previous panel ~ .2 SEARCH SEARCH COMMANDS INDEX >c Change Search and Replace string in line(s) >f Find Locate string in a specific column >l Locate Locate next occurrence of string >m Modify Search and Replace string in line(s) >n Next Change Relative file position >po Point Change Absolute file position >se SEarch Locate multiple strings >b Bottom Position past last line in buffer >t Top Position above first line >.. (Default) Return to previous panel ~ .3 MODIFY LINE - BLOCK - COLUMN - MODIFICATION COMMAND INDEX >a Append Append string to line >c Change Replace string in line(s) >g Gmodify Reformat line >ib IBefore Insert line before current line >i Insert Insert line after current line >j Join Join Adjacent lines >m Modify Replace string in line(s) >oo OOps Replace a modified line >o Overlay Modify line with mask >r Retype Replace line >co COpy Copy a block of lines >d Delete Delete a block of lines >mov MOVe Move a block of lines >bc BCOL Blank a column of text >cc CCOL Copy a column of text >dc DCOL Delete a column of text >mc MCOL Move a column of text >fo FOrmat Format (rewrap a column of text) >.. (Default) Return to previous panel ~ .4 CONFIG CONFIGURATION/SETUP COMMAND INDEX >bi BInd Bind key to key function >br BRief Turn off display of changed lines >key KEYdef Name and define a key >li LInesz Set the maximum line size >mode MODE Change edit environment >ob OBject Create and maintain OBJECTS >pa PAgesz Set PGUP PGDN page length >s SYmbol Change a control character >ta TABset Set new tab stops >v Verify Turn on display of changed lines >.. (Default) Return to previous panel ~ .5 DISPLAY DISPLAY INFORMATION/STATUS COMMAND INDEX >ec ECho Echo character string to the terminal >fn FName Display the default file name >h Help Display help information >mode MODE Display mode settings >p Print Display lines changing file position >pp PPrint Display lines in place >ps PSymbol Display the current symbol characters >w Where Display the current line number >ist IST Display information about SysEdit Publisher >.. (Default) Return to previous panel ~ .6 CONTROL EDIT MODE CONTROL COMMANDS INDEX >cd CD Change current working directory >log LOG Start Logging events to disk >que QUERY Help user build EDIT commands >sh SHell Execute a UNIX command >x Xeq Execute external command file >/* Comment Place comments at end of command lines >* *[n] Repeat previous commands on command line >.. (Default) Return to previous panel ~ .7 HOW HOW TO INFORMATION INDEX >hstart Start a Session >hend End a Session >hmacro Create and use a Keyboard Macro >hcmacro Create and use Command Macro >hchmod Change SysEdit modes >.. (Default) Return to previous panel ~ .8 WHAT GLOSSARY or WHAT IS IT? INFORMATION INDEX >wsysedit What is SysEdit? >wmodes All about MODES? >wkeys All about the KEYBOARD interface >.. (Default) Return to previous panel ~ . wsysedit What is SysEdit? The Information Systems Technologies Full Screen Text Processor (SysEdit) is a full featured text/data editing tool. It runs on several different hardware platforms. Information on installation and configuration for a specific hardware platform will be found a separate installation guide. The SysEdit program allows creation, modification and examination of ASCII text files. With caution, SysEdit can also be used to edit and modify binary files. SysEdit is used for programming, high speed data entry, word processing, data file editing and other applications. EDIT ENVIRONMENT SysEdit is easy to learn and use. The default key bindings assign key functions to the expected keys. HOME, END, DEL, PGUP, PGDN (etc.) all do what most users expect them to do. During an edit session all operations to the file are done to a work buffer image. This protects existing files from undesired modification. To improve performance SysEdit keeps as much of the file in memory as it can. The maximum and default maximum memory allowed in a session is configured when the software is installed. When a file is larger than the maximum memory allowed the least recently used portions of the file will be paged out to disk. >.. (Default) Return to previous panel. ~ . wmodes WHAT ARE SYSEDIT MODES? SysEdit provides three simple modes of operation. 1. SCREEN mode is used during interactive SysEdit sessions to view and modify text. Powerful key functions and keyboard macros ease the editing task. Many users can do all their editing in SCREEN mode and do not have to learn the more complex EDIT mode commands. 2. EDIT mode has more than 70 commands that allow text search, replacement, file saving, loading, text display, and modification. Each powerful command can be used with others to create command macros and files of external command macro programs. 3. LINE mode provides a simple method for entering new text one line at a time. UNIX users use this mode is to enter text on terminals that do not support cursor addressed full screen editing. One other advantage of LINE mode is the ability to duplicate text from the previous line. Note: All modification, insertion and deletion happens in the work file buffer and nothing is done to the original file until a FILE, SAVE, UNLOAD, or DUNLOAD command copies the work version back to disk. >wscreen More on SCREEN mode >wedit More on EDIT mode >wline More on LINE mode >.. (Default) Return to previous panel. ~ . wscreen SCREEN MODE SCREEN mode provides a simple way of entering and viewing text on terminals and in windowing environments that support cursor movement. SCREEN mode displays an optional status line showing the current file being edited, line number position, column number and the INSERT REPLACE toggle value. When the INSERT/REPLACE toggle on the status line shows INSERT all entered text is inserted into the file at the current cursor position. Carriage returns cause the insertion or splitting of lines. When the INSERT/REPLACE toggle on the status line shows REPLACE all text typed overlays the text already in the file. Carriage returns force the cursor to the beginning of the next existing line. When in SCREEN mode changing to EDIT MODE is done with a single keystroke or by pressing the ESC key twice. To return to SCREEN mode press the ESC key twice or press the key assigned to SCREEN_TOGGLE. >.. (Default) Return to previous panel. ~ . wedit EDIT MODE EDIT mode commands provide a way of telling SysEdit what needs to be done to the text in a file. There are more than 70 powerful commands that allow searching, replacing, display, and other forms of file modification. The EDIT mode help command gives descriptions of all commands. Edit commands can be entered one at a time or can be strung together into a macro. To build a macro of multiple commands each command must be separated by a comma or the current command separator character (Symbol SEMICO). Before SysEdit executes an entered command line the command line is evaluated and modified if necessary to: 1. Replace ^nnn octal strings by the proper ASCII character. 2. Replace % variables with their current values. Variables currently supported are: %PATH is replaced with the current file path. %FILE is replaced with the current file name. %LINE is replaced with the current line number. %COL is replaced with the current column number. %CWD is replaced with the current working directory. %PID is replaced with the current process id. %UID is replaced with the current user id. %(environment variable name) replaced with the value of the environment variable name. >.. (Default) Return to previous panel. ~ . wline LINE MODE LINE MODE is used to enter lines of text into a file while using a terminal or network connection that does not support cursor addressed full screen features. LINE MODE also allows the entry of special non-display characters for inclusion in the file. While in LINE mode SysEdit allows entry of any upper/lower case alphabetic characters and all numeric and special characters. Non-display characters can be entered by using a ^ and a one to 3 position octal number equal to that character. At the end of each line press the RETURN or ENTER key to place the line in the file. To insert a blank line in the file enter at least one space before pressing RETURN or ENTER, otherwise SysEdit will pop into to EDIT mode. A single keystroke in LINE mode forces SysEdit to EDIT or SCREEN mode. Pressing return on a null text line will force EDIT mode and pressing the key assigned to SCREEN_TOGGLE (or ESC ESC) will force SysEdit into SCREEN mode. >.. (Default) Return to previous panel. ~ .wkeys ALL ABOUT THE KEYBOARD INTERFACE One of the most important features of any software is the ability for the user to create a comfortable environment to work in. SysEdit provides this user configurable environment via several EDIT mode commands that customize the "look and feel". These commands can be executed at any time or as part of the configuration file that is executed when SysEdit begins a session. Terminals, UNIX workstations and PCs all have keyboards. They all support keys named F1, F2, HOME, END, PGUP, PGDN etc. However few of them generate the same output (Escape sequence) when a key is pressed. This causes great pain for programmers and users that would like the HOME key to do the same predictable thing each time it is pressed. To overcome this problem the SysEdit KEY MANAGER has the KEYDEF command to map a hardware generated escape sequence to a default or user defined KEY NAME and the BIND command to bind one or more KEY FUNCTIONS, KEY MACROS and/or text to a specific KEY NAME. >wkeydefs DEFINITIONS OF TERMS - NAME, FUNCTION, MACRO, MANAGER >wkeycntl CONTROL - KEY FUNCTIONS >wkeycurs CURSOR MOVEMENT - KEY FUNCTIONS >wkeydel DELETE - KEY FUNCTIONS >wkeycopy COPY - KEY FUNCTIONS >wkeymove MOVE - KEY FUNCTIONS >.. (Default) Return to previous panel. ~ .wkeydefs TERMINOLOGY & DEFINITIONS Here is a definition of some of the terms commonly used in SysEdit documentation to describe the Keyboard Interface. KEY NAME: Is what you call that thing you press on the keyboard. Examples: "F1", "HOME", "PGUP" etc. KEY FUNCTION: Is what happens when a specific key is pressed. Each KEY FUNCTION SysEdit supports has a name. Examples: CRSR_UP, CRSR_RIGHT, MOVE_BLOCK, CRSR_HOME, CRSR_END, CRSR_PGUP etc. KEY MACRO: Is defined with the EDIT mode BIND command. It consists of multiple KEY FUNCTIONS and/or text strings that are generated with the press of a single KEY NAME. KEY MANAGER: Is the part of SysEdit that converts a pressed KEY into to a KEY FUNCTION or KEY MACRO. When a physical key is pressed an ASCII sequence is sent from the keyboard to the SysEdit program. Next the KEY MANAGER interprets the ASCII sequence and finds the associated KEY NAME. Then the BIND table entry for that KEY NAME is checked to see what KEY FUNCTIONS, and TEXT is to be generated. >.. (Default) Return to previous panel. ~ . wkeycntl CONTROL KEY FUNCTIONS Each of the following KEY FUNCTIONS does some time saving job for you. When you have become familiar with them you will save time in every edit session. It is important for you to understand how they work. Where possible the KEY FUNCTIONS do the same thing in each mode. Descriptions are provided for each mode. <=================== ABORT Key function =====================> Mode Effect ALL If file has not been modified SysEdit ABORTS the session and returns to the Operating System. If the file has been modified then the user is asked if it is OK to quit. <=================== COMMAND Key Function =====================> Mode Effect SCREEN Moves cursor to the bottom line on the screen, and allows entry of an EDIT mode command/macro. Lines on the screen are not modified unless the entered command modifies them or the current line pointer moves out of range of lines shown on the screen. EDIT & LINE No Action. <=================== REPEAT_COMMAND Key Function =====================> Mode Effect ALL Loads the previous EDIT mode command line entered and executes it. SysEdit then returns to the original mode. <=================== SCREEN_TOGGLE Key Function =====================> Mode Effect SCREEN Immediate change to EDIT mode. EDIT Immediate change to SCREEN mode without executing the command line. LINE Inserts the current non null line into the file then enters SCREEN mode. <=================== EDIT_MODE Key Function =====================> Mode Effect ALL Forces an immediate change to EDIT mode and awaits the next command line. <=================== LINE_MODE Key Function =====================> Mode Effect ALL Forces an immediate change to LINE mode and awaits the next input line. <=================== SCREEN_MODE Key Function =====================> Mode Effect ALL Forces an immediate change to SCREEN mode and places the cursor on the current line ready for editing. <=================== INSERT_TOGGLE Key Function =====================> Mode Effect SCREEN Changes character input from INSERT to REPLACE or from REPLACE to INSERT. EDIT & LINE Turns INSERT ON or OFF for this command line. Allows insertion of text between characters being duplicated from the previous command line. <=================== INSERT Key Function =====================> Mode Effect ALL Changes character input to INSERT. <=================== REPLACE Key Function =====================> Mode Effect ALL Changes character input to REPLACE. <=================== RECORDING Key Function =====================> Mode Effect ALL Turn ON/OFF the RECORDING of keystrokes in all modes. These recorded characters are used by the PLAYBACK key function. <=================== PLAYBACK Key Function =====================> Mode Effect ALL Turn OFF RECORDING of keystrokes in all modes and PLAYBACK the current buffer of recorded keystrokes. <=================== TABSET Key Function =====================> Mode Effect SCREEN Turn ON/OFF a TAB stop in the current column. EDIT & LINE No Action. <=================== TOSS_CHAR Key Function =====================> Mode Effect ALL Any key bound to TOSS_CHAR has no effect. This key function is used to avoid the accidental entry of unwanted escape sequences into the commands or text being entered. <=================== XEQ_OBJECT Key Function =====================> Mode Effect SCREEN When a key bound to XEQ_OBJECT is pressed SysEdit examines the characters prior to the cursor on the current line of text to see if they match any of the defined OBJECT names. If a match is found SysEdit replaces the OBJECT name with the bound key_functions, values and text. >.. (Default) Return to previous panel. ~ .wkeycurs CURSOR KEY FUNCTIONS <=================== BKSP_ERASE Key function =====================> Mode Effect SCREEN Moves the cursor one position left on left on the current line and erases the character found there. When at the beginning of the line, it positions to the end of the previous line. EDIT & LINE Positions the cursor one position to the left and erases the character found there. Does nothing when at the beginning of the line. <=================== TAB_RIGHT Key function =====================> Mode Effect SCREEN When MODE TAB and INSERTing characters a real TAB ^11 is placed in the line and appears as white space on the screen. When mode TAB and REPLACing characters the cursor is positioned to the next TAB STOP column. Real TABS show as white space. When MODE NTAB and INSERTing characters, TAB_RIGHT forces spaces to be placed in the line until the next TAB STOP column. When MODE NTAB and REPLACing characters the cursor is placed in the next TAB STOP column. Real TABS show as TILDE. EDIT Places a TAB character (^011) into the command line. LINE When mode TAB is ON it places a TAB character into the input line. When mode TAB is OFF it inserts blanks into the line until the next tabstop. <=================== TAB_LEFT Key function =====================> Mode Effect SCREEN When mode NTAB is active the cursor is moved to the previous tab stop column. When mode TAB is active there is no action. EDIT Acts the same as a single character backspace. LINE Whenmode NTAB is active the cursor is backspaced to the previous tab stop column. All characters in the way are deleted. <=================== CRSR_UP Key function =====================> Mode Effect SCREEN Moves the cursor up one line in the file. Column number does not change. EDIT & LINE No Action. <=================== CRSR_DOWN Key function =====================> Mode Effect SCREEN Moves the cursor down one line in the file. Column number does not change. EDIT & LINE No Action. <=================== CRSR_RIGHT Key function =====================> Mode Effect SCREEN Moves cursor one position to the right on the current line. If the cursor is already at LINESZ it positions to the beginning of the next line. EDIT Duplicates one character from the previous command line. Turns INSERT OFF. LINE Duplicates one character from the previous input line. Turns INSERT OFF. <=================== CRSR_LEFT Key function =====================> Mode Effect SCREEN Moves cursor one position left on the current line. If already at the beginning of the current line the cursor moves to the end of the previous line. EDIT & LINE Same as the BACKSPACE command. <=================== CRSR_HOME Key function =====================> Mode Effect SCREEN Places the cursor in column 1 of the current line. If already in column 1 it places the cursor at the beginning of the top line on the screen. If the cursor is already on the top line it sets the CURRENT LINE POINTER to the TOP of the file. EDIT & LINE Returns the cursor to the beginning position on the current line and sets the line length to zero. Sets INSERT OFF. <=================== CRSR_BOL Key function =====================> Mode Effect ALL Moves cursor to the beginning of the current line. <=================== CRSR_BOF Key function =====================> Mode Effect SCREEN Moves cursor to the beginning (TOP) of the file. EDIT & LINE NO ACTION. <=================== CRSR_END Key function =====================> Mode Effect SCREEN Positions the cursor to the end of the current line. If already at the end of the current line the cursor is positioned to the end of the last line on the screen. If already at the end of the last line the CURRENT LINE POINTER is set to the BOTTOM of the file. EDIT Duplicates the rest of the previous command line. LINE Duplicates the rest of the previous input line. <=================== CRSR_EOL Key function =====================> Mode Effect ALL Moves cursor to the end of the current line. <=================== CRSR_EOF Key function =====================> Mode Effect SCREEN Moves cursor to the end (BOTTOM) of the file. EDIT & LINE NO ACTION. <=================== CRSR_WORDRIGHT Key function =====================> Mode Effect SCREEN Places the cursor on the first character of the next word on the current line. If at the end of the current line it places the cursor at the beginning of the next line. EDIT Duplicates the next word from the previous command line. Turns INSERT OFF. LINE Duplicates the next word from the previous input line. Turns INSERT OFF. <=================== CRSR_WORDLEFT Key function =====================> Mode Effect SCREEN Places the cursor at the beginning of the previous word on the current line. When at the beginning of the current line it places the cursor at the end of the previous line. EDIT Erases the previous word entered on the current comnand line. LINE Erases the previous word entered on the input line. <=================== CRSR_PGUP Key function =====================> Mode Effect SCREEN Moves the cursor or shifts the screen view up the file PAGESZ number of lines in the window. EDIT & LINE No Action. <=================== CRSR_PGDN Key function =====================> Mode Effect SCREEN Moves the cursor or shifts the screen view down the file PAGESZ number of lines in the window. Use the HELP PAGESZ command for information on how to change the number of lines moved with CRSR_PGDN. EDIT & LINE No Action. <=================== CRSR_PGRIGHT Key function =====================> Mode Effect SCREEN Moves the cursor 1/2 screen width to the right on the current line. If this moves the cursor beyond the width of the screen then the view of the file is ] shifted 1/2 screen right also. EDIT & LINE No Action. <=================== CRSR_PGLEFT Key function =====================> Mode Effect SCREEN Moves the cursor 1/2 screen width to the left on the current line. If this moves the cursor beyond the width of the screen then the view of the file is shifted 1/2 screen left also. EDIT & LINE No Action. <=================== DUP_CHAR Key function =====================> Mode Effect SCREEN Duplicate corresponding character from previous line in the file. Characters can be inserted or replaced on the current line. EDIT & LINE No Action. <=================== DUP_FIELD Key function =====================> Mode Effect SCREEN Duplicate corresponding characters from previous line until the next tab stop column. Characters can be inserted or replaced on the current line. EDIT & LINE No Action. <=================== DUP_LINE Key function =====================> Mode Effect SCREEN Duplicate corresponding characters from previous line until the end of the line. Characters can be inserted or replaced on the current line. EDIT & LINE No Action. <=================== END_LINE Key function =====================> Mode Effect SCREEN When REPLACING characters it moves the cursor to column 1 of the next line. When INSERTing characters it creates a new line containing the remainder of the current line then it positions to column 1. EDIT Ends the command line and executes the command(s). If a null command line was entered it forces a change to LINE mode. LINE Ends the current data line and moves the cursor to the beginning of the next data line. If no data was entered it forces a change to EDIT mode. <=================== FIND_MATCH Key function =====================> Mode Effect SCREEN When this key is pressed and the cursor is placed on a: { The cursor is moved to the next matching } } The cursor is moved to the previous matching { ( The cursor is moved to the next matching ) ) The cursor is moved to the previous matching ( [ The cursor is moved to the next matching ] ] The cursor is moved to the previous matching [ < The cursor is moved to the next matching > > The cursor is moved to the previous matching < >.. (Default) Return to previous panel. ~ . wkeydel DELETE KEY FUNCTIONS <=================== DELETE_CHAR Key function =====================> Mode Effect SCREEN Deletes the character under the cursor. If at the end of a line the DELETE_CHAR key function will cause the beginning of the next line to be appended to the end of the current line. EDIT Delete (skip over) a single character at the current position in the previous command line. Turns INSERT OFF. LINE Delete (skips over) a single character in the previous input line. Turns INSERT OFF. <=================== DELETE_WORD Key function =====================> Mode Effect SCREEN Deletes from the character under the cursor to the next character on the current line of a different type. There are four different types of characters: White space(tabs and spaces), Alpha (A-Z and a-z), Numeric, and Special characters ( / * & ^ % $ # @ ! . etc.). EDIT & LINE No Action. <=================== DELETE_LINE Key function =====================> Mode Effect SCREEN Deletes the current line of text in the file. EDIT & LINE No Action. <=================== BLANK_COLUMN Key function =====================> Mode Effect SCREEN First press marks the first line and column position of the column to be blanked and displays "BLANK WHAT COLUMN?" on the status line. After positioning to the last line and column of the column to be blanked (filled with spaces) the second press forces the blanking of all characters found in the defined column. Note: Pressing one of the keys assigned to other BLOCK or COLUMN functions will reset this process. EDIT & LINE No Action. <=================== DELETE_BLOCK Key function =====================> Mode Effect SCREEN First press marks the first line of the block to be deleted and displays "DELETE WHAT BLOCK?" on the status line. The second press deletes all lines from the marked line to the current line. Pressing one of the keys assigned to other BLOCK or COLUMN functions will reset this process. Note: If "DELETE WHAT BLOCK?" shows on the status line you can assume the bomb is armed. An accidental press of the key assigned to DELETE_BLOCK will remove all lines from the marked line to the current line. EDIT & LINE No Action. <=================== DELETE_COLUMN Key function =====================> Mode Effect SCREEN First press marks the first line and column position of the column to be deleted and displays "DELETE WHAT COLUMN?" on the status line. After positioning to the last line and column of the column to be deleted the second press forces the deletion of all characters found in the defined column. Any characters to the right of the defined column will be shifted left the width of the column. Note: Pressing any of the other BLOCK or COLUMN key functions will abort the DELETE_COLUMN key function. EDIT & LINE No Action. >.. (Default) Return to previous panel. ~ .wkeycopy COPY KEY FUNCTIONS <=================== COPY_BLOCK Key function =====================> Mode Effect SCREEN First press marks the first line of the block to be copied and displays "COPY WHAT BLOCK?" on the status line. The second press marks the last line of the block to be copied and displays "COPY BLOCK WHERE?" on the status line. The third press forces the copying of the marked block of lines to the current line in the file. Pressing one of the keys assigned to other BLOCK or COLUMN functions aborts the COPY_BLOCK function. EDIT & LINE No Action. <=================== COPY_COLUMN Key function =====================> Mode Effect SCREEN After positioning to the upper left corner of the column to be copied. Press the key assigned to COPY_COLUMN to mark the beginning of the column. SysEdit will then display "COPY WHAT COLUMN?" on the status line. Position to the lower right corner of the column to be copied and press the COPY_COLUMN key again to mark the end of the column. SysEdit then displays "COPY COLUMN WHERE?" on the status line. Position to the target column location where you want the upper left corner of the column to be located and press the COPY_COLUMN key again. If INSERT shows on the status line the copied column will be inserted and push old text to the right. If REPLACE shows on the status line the new column will overlay existing text at the target location. Note: Pressing one of the keys assigned to other BLOCK or COLUMN functions will abort COPY_COLUMN. EDIT & LINE No Action. >.. (Default) Return to previous panel. ~ .wkeymove MOVE KEY FUNCTIONS <=================== MOVE_BLOCK Key function =====================> Mode Effect SCREEN First press marks the first line of the block to be moved and displays "MOVE WHAT BLOCK?" on the status line. The second press marks the last line of the block to be moved and displays "MOVE BLOCK WHERE?" on the status line. The third press forces the movement of the marked block of lines to the current line in the file. Pressing one of the other BLOCK or COLUMN functions will abort the MOVE_BLOCK. EDIT & LINE No Action. <=================== MOVE_COLUMN Key function =====================> Mode Effect SCREEN After positioning to the upper left corner of the column to be moved. Press the key assigned to MOVE_COLUMN to mark the beginning of the column. "MOVE WHAT COLUMN?" will display on the status line. Position to the lower right corner of the column and press the MOVE_COLUMN key again to mark the end of the column. "MOVE COLUMN WHERE?" will display on the status line. Position to the line and column where you want the upper left corner of the column to be moved. Press MOVE_COLUMN again to move the marked column. When INSERT shows on the status line the moved column will shift old text to the right when the column is moved. When REPLACE shows on the status line new text will overlay the old. The source column will always be left blank and no characters will be shifted. NOTE: Pressing a key assigned to another BLOCK or COLUMN function will abort the MOVE_COLUMN. EDIT & LINE No Action. >.. (Default) Return to previous panel. ~ . hstart STARTING A SESSION A single SysEdit session can be used to stream edit or interactivly edit one or more files. Most users are familiar with INTERACTIVE edit sessions. During a interactive session the user manually modifies or views the text and places the modified data on disk when satisfied. STREAM edit sessions are both more powerful and more dangerous. Stream editing is used when a user wants one or more files to be modified or searched automatically. One or more known good EDIT mode commands and a list of files are passed to SysEdit and it processes the commands against each file then continues to the next. GENERAL SYSEDIT COMMAND FORMAT se [-n[k][i][s]] [-c "cmnd"] [-f cmndfile] [path]filename ... "se" is the name of the executable program found in /usr/local/IST. The optional -n sub-commands, k i and s instruct SysEdit to turn off certain functions. The "k" turns off ISTSE.$TERM initialization, the "i" turns off ISTSE.CFG file initialization and the "s" turns off SCREEN mode even if the $TERM type is supported. The -c and -f options force a STREAM edit session and turn off SCREEN mode for the rest of the session. When -c is used it is followed by a single EDIT mode command macro enclosed in quotes. This command macro will be processed automatically against all files in the filename list. When -f is used it is followed by a filename containing a series of valid EDIT mode commands or macros. This command file will be processed against all files in the filename list. If neither -c or -f options are present SysEdit will start a normal interactive session. Optional path and filename combinations can be appended to the command until the maximum shell (sh, csh, ksh) command size is reached. SYSEDIT STARTUP PROCEDURE When SysEdit starts a session it first checks the License information in /usr/local/IST to insure this session is allowed. If the -nk option was not used SysEdit gets the TERM environment variable and searches the users HOME directory then the /usr/local/IST directory for the file ISTSE.$TERM. This file contains EDIT mode commands that set the proper default modes, key definitions and key bindings. Next, (if the -ni option was not used) SysEdit searches the users current directory then the users HOME directory for the ISTSE.CFG file. This file can contain any additional mode settings, key definitions and bindings specific to this user or files in the current directory. Also, (if the -ni option was not used) Before each file is edited or examined SysEdit searches the users HOME directory then the /usr/local/IST directory for the ISTSE.sfx.INIT file. This allows automatic configuration for languages and other files with a specific suffix. Example: If the filename being edited is config_it.c the initialization file name searched for would be ISTSE.c.INIT. SYSEDIT STARTUP EXAMPLES se To interactively edit an unnamed empty file. se /users/testfile To interactivly edit the file "testfile" in the /users directory. If the file does not exist it is not created until the user saves or files entered text. see /etc/passwd To interactively examine (not modify) the passwd file in the /etc directory. se *.c To edit (one after another) all files in the current directory that end with the suffix .c. se -c "c/dog/cat/ga;file" *.ltr To stream edit all files in the current directory with the .ltr suffix and change all occurances of the string "dog" to "cat". se -f cmnds.in tortuga To stream edit the tortuga file in the current directory and process it with the EDIT mode commands found in the file cmnds.in. >.. (Default) Return to previous panel. ~ . hend ENDING A SESSION SysEdit sessions can be ended in one of many ways depending on what you want done with the data in the memory buffer. QUITING AND SAVING THE FILE QUITING WITHOUT SAVIND THE FILE ABORTING THE SESSION >.. (Default) Return to previous panel ~ . hmacro CREATION OF A KEY MACRO Key Macros are built from one or more characters and/or key functions. They are created with the KEY and BIND commands. The KEY command lets you define a NAMED KEY. Some KEYS are already NAMED, like cntl_a, up, down, pgup, pgdown, etc. You can see a list of the already named keys in APPENDIX B of the SysEdit reference manual. To create a NAMED KEY for use with our macro we use the following EDIT MODE command. key d2eof "^33de" When SysEdit sees the string ESC (^33) "de" in the input stream it will know the d2eof key has been pressed. Even so, SysEdit will do nothing unless that keyname has been bound (with the BIND command) to one or more key functions. The BIND command to tie the d2eof key to the proper key functions to "delete to the end of file" is: bind d2eof delete_block crsr_end crsr_end crsr_end delete_block You can create any immagined macro using this technique. If your macros are frequently used you should put them in your startup files for automatic key definition and binding. >.. (Default) Return to previous panel ~ . hcmacro CREATE AN EDIT COMMAND MACRO EDIT command macros are used to locate, view and modify text within a file in the easiest way possible. As shown in other parts of the HELP information there are many commands that each do some simple specific task. When these commands are combined into MACROS they become much more powerful. An example of simple commands to globally replace 2 strings on lines only containing both strings. In EDIT mode enter; t /* position to the top of the file sea /wash/ & /ton/ /* search for line with both strings c/wash/bath/ /* change string "wash" to "bath" c/ton/2000 lbs/ /* change string "ton" to "2000 lbs" If SysEdit didn't have MACROS you would have to enter these commands again for each occurance you wanted changed. This could get boring quick. Macros are created from combining EDIT mode commands like the ones above and separating them by the current value of the semico symbol. (Default ;) The macro to do this set of commands to the whole file is: sea /wash/ & /ton/;c/wash/bath/;c/ton/2000 lbs/;* Notice the ";* on the end of the line. This is the EDIT mode repeat command. It tells SysEdit to repeat the entered MACRO until the TOP or BOTTOM of the file is reached. If you do something silly like create a infinitely looping MACRO you can normally end the command loop with the ABORT (Default cntl_c) key function. >.. (Default) Return to previous panel ~ . hchmod Change SysEdit modes >.. (Default) Return to previous panel ~ . a APPEND COMMAND PURPOSE: Appends a string to the end of the current line. FORMAT: A[PPEND] string The string is ended with the end of the command line or a semicolon. If at TOP or BOTTOM the append is ignored. There must be one blank (space) following A[PPEND] preceding the string or the results will not be as desired. If the appended line is greater than LINESZ then the append is ignored and an error message is displayed. >.. (Default) Return to previous panel. ~ . bi BIND COMMAND FORMAT1: BI[ND] key_name1 [key_value]|[key_function]| ["text_string"]|[<playback]...] PURPOSE: To bind one or more KEY FUNCTIONS to a KEY NAME and remap the keyboard or create MACROS. The bind command can use a combination of key_names, key_values, function_names, text strings and the playback value from a recorded macro. This command forces all future keystrokes from key_name1 to generate the series of key_values, function_names, and text_strings into the keyboard input stream. BEWARE! You can bind illogically! Also BEWARE! you can remove a key from the keyboard and be unable to get it back during the current edit session. The (se_setup) program can help you create a series of bind commands to properly map the keyboard. You can also place frequently used macros (BIND commands) in your ISTSE.CFG file so they will be loaded each time you start the SE program. FORMAT2: BI[ND] PURPOSE: Display the current key bindings and macros. >keynames List of defined KEY NAMES >keyfunctions List of defined KEY FUNCTIONS >.. (Default) Return to previous panel ~ . keynames The following are the KEYNAMES already defined. Create others with the KEYDEF command. KEY_NAMES ------------------------------------------------------------------------ CNTL_A CNTL_B CNTL_C CNTL_D CNTL_E CNTL_F CNTL_G BS CNTL_H TAB CNTL_I CNTL_J CNTL_K CNTL_L RETURN ENTER CNTL_M CNTL_O CNTL_P CNTL_Q CNTL_R CNTL_S CNTL_T CNTL_U CNTL_V CNTL_W CNTL_X CNTL_Y CNTL_Z CNTL_[ CNTL_\ CNTL_] CNTL_6 CNTL_- SP ! " # $ % & ' ( ) * + , - . / 0 1 2 3 4 5 6 7 8 9 : ; < = GT ? @ A B C D E F G H I J K L M N O P Q R S T U V W X Y Z [ \ ] ^ _ ` a b c d e f g h i j k l m n o p q r s t u v w x y z { | } TILDE DELTA F1 F2 F3 F4 F5 F6 F7 F8 F9 F10 F11 F12 HOME UP PGUP LEFT RIGHT ENDKEY DOWN PGDN INS DEL >.. (Default) Return to previous panel ~ . keyfunctions *************** SysEdit Valid Key Function Names **************** <==== Cursor Movement ====> <= MODE CHANGE => <== CONTROL ==> BKSP_ERASE CRSR_BOF SCREEN_TOGGLE ABORT FIND_MATCH CRSR_END EDIT_MODE COMMAND TAB_RIGHT CRSR_EOL LINE_MODE END_LINE TAB_LEFT CRSR_EOF SCREEN_MODE HELP CRSR_UP CRSR_PGUP INSERT_TOGGLE OOPS CRSR_DOWN CRSR_PGDN INSERT REPEAT_COMMAND CRSR_RIGHT CRSR_WORDLEFT REPLACE TABSET CRSR_LEFT CRSR_WORDRIGHT TOSS_CHAR CRSR_HOME CRSR_PGLEFT XEQ_OBJECT CRSR_BOL CRSR_PGRIGHT <== DELETE ==> <= BLOCK/COLUMN => <= DUPLICATE => BKSP_ERASE MOVE_BLOCK DUP_CHAR DELETE_CHAR COPY_BLOCK DUP_FIELD DELETE_WORD DELETE_BLOCK DUP_LINE DELETE_LINE MOVE_COLUMN RECORDING DELETE_BLOCK COPY_COLUMN PLAYBACK DELETE_COLUMN DELETE_COLUMN BLANK_COLUMN >.. (Default) Return to previous panel. ~ . bc BLANK COLUMN COMMAND FORMAT: BCOL[UMN] start_line start_col col_width col_length PURPOSE: To Blank a column of text. The start line and column positions represent the upper left corner of the desired column. >.. (Default) Return to previous panel. ~ . br BRIEF COMMAND FORMAT: BR[IEF] PURPOSE: This command supresses the printing of changed lines by the commands - APPEND - CHANGE - FIND - GMODIFY - LOCATE MODIFY - NEXT and NFIND. This command reduces the time necessary to change a whole file by avoiding the display of changed lines. The VERIFY command resumes the printing of lines modified by the mentioned commands. >.. (Default) Return to previous panel. ~ . b BOTTOM COMMAND FORMAT: B[OTTOM] PURPOSE: Sets the current line pointer to one past the last line in the file. BOTTOM will be displayed when this position is reached. >.. (Default) Return to previous panel. ~ . cc COPY COLUMN COMMAND FORMAT: CCOL[UMN] [O] source_line source_col col_width col_length target_line target col PURPOSE: Copy a column of text from the source_line and column to the target line and column. If the optional "O" is used the column overlays the existing text at the target line and column. >.. (Default) Return to previous panel. ~ . co COPY COMMAND FORMAT: CO[PY] n [F[ROM][ x]] [T[O][ y]] PURPOSE: Copy n lines from line number x to line y. Both x and y default to the current line number. The number of lines to copy, n, must be supplied. The text will be copied in front of the line now at y. >.. (Default) Return to previous panel. ~ . c CHANGE COMMAND FORMAT1: C[HANGE]!string1!string2[![G][n]] FORMAT2: C[HANGE]!string1!string2[![G][A]] FORMAT3: C[HANGE](col)!string1!string2[![n]] FORMAT4: C[HANGE](col)!string1!string2[![A]] PURPOSE: Start with the current line and change any occurrences of string1 with string2. The ! represents the delimiter character and can be any of the valid non-control characters on the keyboard. When G is used (Format1 and Format2) all string1s in the line will be changed. When (col) is used (Format3 and Format4) only string1s found in the requested column will be changed. When number n (Format1 and Format3) is used, change n lines starting with the current line. When A is used (Format2 and Format4) change all lines in the file then return to the original line number. If positioned at TOP or BOTTOM the CHANGE will be ignored. >.. (Default) Return to previous panel. ~ . du DUNLOAD COMMAND FORMAT1: DU[NLOAD] [-A] filename [n] PURPOSE: This command allows the unloading of n lines of text to filename and the subsequent deletion of those records from the workfile. The optional -A forces all lines to be appended if the file exists. The number n defaults to 1 line. FORMAT2: DU[NLOAD] [-A] filename TO string PURPOSE: This version of the DUNLOAD command unloads and deletes all lines in the file from the current line until a line if found containing the string. The line with the string is in is not unloaded or deleted. WARNING: The filename must be valid or the file will not be created and the records will be lost when deleted. >.. (Default) Return to previous panel. ~ . dc DELETE COLUMN COMMAND FORMAT: DCOL[UMN] start_line start_col col_width col_length PURPOSE: Delete a column of text in the file. The start line and column positions refer to the upper left corner of the desired column. The characters to the right of the column are shifted to the left after the column is deleted. >.. (Default) Return to previous panel. ~ . d DELETE COMMAND FORMAT1: D[ELETE] [n] PURPOSE: Delete n lines starting at the current line. The value of n defaults to 1. The user is left on a .null. line at the same line number the delete started on. Any movement to other lines in the file will eliminate the .null. line and the next line in the file will own the deleted line number. FORMAT2: D[ELETE] TO string PURPOSE: Delete lines starting at the current line until a line is found containing the string. BE VERY sure that you have entered the string properly or all lines from current line to the BOTTOM will be lost. >.. (Default) Return to previous panel. ~ . ec ECHO COMMAND Format: EC[HO] "string" PURPOSE: Echo a string of characters to the terminal. Used to initialize a terminal at the beginning of a SysEdit session. The string must be surrounded by double quote (") characters. All characters are allowed in the string but non-display characters must be represented in octal form (^nnn where nnn is the octal number representing the character). >.. (Default) Return to previous panel. ~ . e EDIT COMMAND Format: ED[IT] [filename] PURPOSE: Begin editing a new file without exiting and restarting SysEdit. If the current work file has not been changed, it is cleared and the new file is loaded and ready for editing. If changes have been made you will be asked if you want to SAVE or IGNORE the changes before starting to edit the new file. The new filename becomes the default file name. >.. (Default) Return to previous panel. ~ . fil FILE COMMAND FORMAT: FIL[E] [-A] [filename] PURPOSE: This command saves the current work file to disk and terminates the current edit session. If the optional -A is used the work file in memory will be appended to the file if it exists. The filename must be valid, if supplied. If not supplied, then the original file will be over-written. If this is a new file then the user will be asked for a valid filename. >.. (Default) Return to previous panel. ~ . fn FNAME COMMAND FORMAT: FN[AME] PURPOSE: Display the current default file name. If this is a new file and no save has yet occurred the command will print (null). >.. (Default) Return to previous panel. ~ . fo FORMAT COMMAND FORMAT: FO[RMAT] [CO[MPRESS]] [N[OWRAP]] [A[LL]] [/[source_col[ source_width]]/[target_col[ target_width]]/] [lines] PURPOSE: The format command formats a column of text starting on the current line and shifts the data into the desired format. Lines are split and joined as required to fit as much data into each line as will fit based on the rules requested. Blank lines are not considered formattable. i.e. they are left alone. Lines with leading spaces are considered the beginning of a paragraph unless the COMPRESS option is used. Trailing spaces are always compressed out. The COMPRESS option removes leading spaces from the source column of text before each line is formatted. The NOWRAP option keeps split lines from being joined with other existing lines. The source and target information specify starting column and width. The following are the defaults for each: source_col 1 source_width whole line target_col 1 target_width linesz Examples of valid format commands: fo //10 60/all - Format all lines in the file indented to column 10, 60 characters wide. fo co no all - Format all lines in the file removing (compress) leading spaces with no wrapping of split lines. fo /10 60//20 - Format 20 lines of text starting in column 10, 60 characters wide and place the output in column 1 for a width of linesz. >.. (Default) Return to previous panel. ~ . f FIND COMMAND GENERAL FORMAT: [C][N]F[P][(n1[-n2])] string PURPOSE: Find the next line in the file that contains the string in column n1 or find the next line that contains the string in the range of columns n1-n2. If no line contains the string the command stops at the BOTTOM or TOP of the file depending on the search direction. If preceded by the optional C the command becomes case insensitive and will find a string without regard to upper or lower case characters. If preceded by the optional N FIND stops at the next line in the file NOT CONTAINING the string. If followed by the optional P the FIND searches for the previous line in the file with the string. If no column number(s) are provided column 1 is the default. If only n1 is provided only strings in that column will be found. If n1 and n2 (separated by a dash) are used FIND will stop on any line with the string starting in that range of columns. One space must precede the string. The use of the blanks symbol character (default #) in the string provides a way of matching strings with n blanks at that position in the string. The use of the wild symbol character (default !) in the string provides a way of matching strings with any character at that position in the string. EXAMPLES: CF(10) dog /* case insensitive find next (in col 10) "dog" f(62) Doctor /* find next (in col 62) "Doctor" cfp cap /* case insensitive find previous (in col 1) "cap" f(6-20) Duncan /* find next (starting in col 6-20) "Duncan" >.. (Default) Return to previous panel. ~ . g GMODIFY COMMAND FORMAT: G[modify][Mn][En][Cc][Dc][Bn][S][F][Lc] [Uc][I/str/][A/str/][R/str/][N][W] PURPOSE: To reformat a line of text by copying, deleting, inserting and otherwise modifying text. Gmodify is the most powerful command in the EDitor. The gmodify sub-commands are as follows: [Mn] Move n source chars to the output line. [En] Erase (ignore) n characters in the source line. [Cc] Copy source characters up to character c. [Dc] Delete source characters up to character c. [Bn] Back up n source character positions. [S] Back up to the first source character position. [F] Copy the rest of the source line. [Lc] Copy and convert to lower case until char c. [Uc] Copy and convert to upper case until char c. [I/str/] Insert string into the output line. [R/str/] Insert string into the output line and ignore the equivalent number of source characters. [N] Reverse comparisons in Cc,Dc,Uc,Lc commands. [N] toggles on/off. [W] Write current workline and resume the gmodify command operation on the original source line. >.. (Default) Return to previous panel. ~ . h HELP COMMAND FORMAT: H[ELP] [topic] PURPOSE: To Lookup and Display SysEdit HELP Information. Help is actually a sub-program within SysEdit that loads the ISTSE.HELP file into memory and allows interactive searching thru the INDEXES and help information. If the optional topic is not included a index of available information is displayed and you are given a choice of selections. To return to the previous panel just press return. If there were no previous panels or you enter exit the help sub-program will end. General Screen Editor Information Help IST Keyboard File Positioning Commands Bottom Find Locate Next POint SEarch Top Line Modification Commands Append Change Gmodify Join Modify OOps Overlay Retype File Modification Commands COpy Delete DUnload IBefore Insert LOAd MOVe BCOLumn CCOLumn DCOLumn MCOLumn Screen Editor Control/Display Commands BInd BRief EDit FILe FName Help KEYdef LInesz LOG MODE PAgesz PPrint Print PSymbol QForget Quit SAve SHell Symbol TABset Unload Verify Where Xeq * /* >.. (Default) Return to previous panel. ~ . ib INSERT BEFORE COMMAND FORMAT: IB[EFORE] newline PURPOSE: Insert the newline into the file preceding the current line. There must be one space following IB[EFORE] before the newline data. >.. (Default) Return to previous panel. ~ . ist Information Systems Technologies 13621 S.E. 19th St. Bellevue, Washington 98005 206-644-7441 I.S.T. is the Publisher of the I.S.T. SE full screen editor. This software is not in the public domain. It is protected under the copyright laws of the United States of America. Please write I.S.T. for a current product and price list or for any other questions you have about I.S.T. products. >.. (Default) Return to previous panel ~ . i INSERT COMMAND FORMAT: I[NSERT] newline PURPOSE: Insert the newline into the file following the current line. There must be a space following I[NSERT] or its abbreviation. If MODE TAB is turned on and tabs are entered as part of the newline real tab characters will be inserted in the record. IF MODE NTAB is turned on and tabs are entered as part of the newline spaces will be placed in the line until the next tab stop. >.. (Default) Return to previous panel. ~ . j JOIN COMMAND FORMAT: J[OIN] [string] PURPOSE: Append the following line to the end of the current line. The optional string will be inserted between the two lines of text. OOPS does not repair any user mistakes with this command. Note that a space must precede the optional string. >.. (Default) Return to previous panel. ~ . key KEYDEFINE COMMAND FORMAT1: KEY[DEF] keyname "string of text" PURPOSE: Define a new keyname and associate it with a unique ASCII string. Because terminal manufacturers never came up with a standard for escape sequences software developers have had to make up for this lack. The HOME key on one terminal will seldom generate the same ASCII sequence of characters as another. The KEYDEF command and the BIND command work together to create a user designed keyboard. Most users will only use the KEYDEF and BIND commands in the /usr/local/IST/ISTSE.termtype files. Here is an example of the KEYDEF command: KEY f2 "^33[225z" This command will define the keyname f2 if it is not already defined. It will then load the escape sequence into a table. From that point on (in this edit session) when SE keyboard manager identifies the above escape sequence in the input stream it will output a single integer to the SE keymacro_manager. The keymacro manager will check the bind table to find out what key_functions, and/or text_strings to output to the screen. If the keymacro_manager find no bind information it will put out the octal equivalent of the integer on the screen. FORMAT2: KEY[DEF] PURPOSE: Display the list of currently defined keynames. >.. (Default) Return to previous panel. ~ . loa LOAD COMMAND FORMAT: LOA[D] filename PURPOSE: Load the external file into the work file following the current line. A space must precede the required existing filename. >.. (Default) Return to previous panel. ~ . cd CD COMMAND FORMAT1: CD pathname PURPOSE: Change the current working directory to pathname. This command allows movement around the file system while within SysEdit. >.. (Default) Return to previous panel. ~ . log LOG COMMAND FORMAT1: LOG [-[A][C][D]] filename PURPOSE: Open and begin logging information into the file. When the LOG file is open, selected information is placed in the external file represented by filename. An optional dash (-) followed by A and/or C and/or D is allowed to specify the type of logging to perform. (Default is -CD) The A option causes all selected information to be appended to the existing filename. The C option forces the logging of all executed EDIT mode commands. The D option forces the logging of all lines displayed in EDIT mode and all entered lines in LINE input mode. If a filename is open and another LOG filename command is executed the first file will be closed and the second will be opened. FORMAT2: LOG -E[ND] PURPOSE: Close the log file and terminate logging. >.. (Default) Return to previous panel. ~ . li LINE SIZE COMMAND FORMAT: LI[NESZ] n PURPOSE: Set the maximum line size allowed. The value of n must be greater than 0 and less than 5096. When in LINE INPUT mode the bell will sound when there are only five spaces left on the line. >.. (Default) Return to previous panel. ~ . l LOCATE COMMAND GENERAL FORMAT: [C][N]L[P] string PURPOSE: Locate the line in the work file containing the string. If preceded by the optional C the LOCATE becomes case insensitive. If preceded by the optional N LOCATE finds line without the string. If followed by the optional P LOCATE searches previous lines. The default LOCATE searches following lines. The LOCATE command will stop at BOTTOM or TOP if the conditions are not met. Including the blanks symbol (default #) in the string allows string matching with n blanks in the corresponding position. The use of the wild symbol (default !) in the string allows string matching of any character in the corresponding position. EXAMPLES: l dog /* Locate next "dog" cl cat /* Case insensitive Locate next "cat" cnlp lion /* Case insensitive Not Locate Previous "lion" /* ie. locate previous line without "lion" >.. (Default) Return to previous panel. ~ . mc MOVE COLUMN COMMAND FORMAT: MCOL[UMN] [B][O] source_line source_column column_width column_length target_line target_column PURPOSE: Move a column of text from one location to another within the work file. The optional "B" if used, forces the blanking of the source column. If it is not used the original line is deleted and characters to the right are shifted left. If the optional "O" is used it forces the OVERLAY of the text at the target line and column. >.. (Default) Return to previous panel. ~ . mode INDEX OF MODE COMMANDS >mdisplay MODE DISPLAY Display all current mode settings. >mdm MODE DM Change default max memory. >mnumber MODE NUM/NNUM Turn on/off line number display. >mbak MODE BAK/NBAK Turn on/off creation of .bak files >mocle MODE CLE/NCLE Turn on/off advanced command line editing. >mocolumn MODE COL/NCOL Turn on/off column header display. >minfo MODE INFO/NINFO Turn on/off INFO compatibility. >mindent MODE INDENT/NINDENT Turn on/off auto INDENT in SCREEN mode. >mocount MODE COUNT/NCOUNT Turn on/off the COUNTE symbol counter. >mprompt MODE PROMPT/NPROMPT Turn on/off or modify the EDIT/INPUT prompt. >mnologo MODE NOLOGO Turn off the startup logo. >mshow MODE SHOW Set range of characters to display on screen. >mstartup MODE STARTUP Set the proper startup mode. >mstatus MODE STATUS/NSTATUS Turn on/off the SCREEN mode status line. >mtab MODE TAB/NTAB Turn on/off tab expansion to white space. >mwrap MODE WRAP/NWRAP Turn on/off SCREEN mode wordwrap at linesz. >.. (Default) Return to previous panel ~ . mdisplay FORMAT: MODE DI[SPLAY] PURPOSE: Display all current mode settings and the value of the COUNTE counter if active. >.. (Default) Return to previous panel ~ . mdm FORMAT: MODE DM nnnnnnnnn PURPOSE: Change the current DEFAULT MAXMEM setting. The value nnnnnnnnn can be from 3000000 to the current value of MAXMEM. Increasing this number speeds up the SE program but takes more memory and swap space from the system. MODE DISPLAY shows the current values of both MAXMEM and DEFAULT_MAXMEM. Only the system administrator can change the value of MAXMEM. >.. (Default) Return to previous panel ~ . mnumber FORMAT1: MODE NU[MBER] PURPOSE: Turns on the display of line numbers while in EDIT and LINE INPUT modes. FORMAT2: MODE NN[UMBER] PURPOSE: Turns off the display of line numbers while in EDIT and LINE INPUT modes. Note: MODE NNUMBER is the default. >.. (Default) Return to previous panel ~ . mbak FORMAT1: MODE B[AK] PURPOSE: Turn on .bak file creation when an external file is created or modified with SAVE, UNLOAD, DUNLOAD and FILE commands. The saved file keeps the same name but has a .bak suffix added. MODE BAK is the default. FORMAT2: MODE NB[AK] PURPOSE: Turns off .bak file creation. >.. (Default) Return to previous panel ~ . mocle FORMAT1: MODE CL[E] PURPOSE: Turn on advanced command line editing. Advanced command line editing saves up to 100 of the previous command lines and also allows fetch, modification and re-execution of those commands. This command changes what several key functions do in EDIT mode. CRSR_HOME, CRSR_END, CRSR_RIGHT, CRSR_LEFT, CRSR_PGUP CRSR_PGDN, INSERT_TOGGLE, DELETE_CHAR all act differently. FORMAT2: MODE NCL[E] PURPOSE: Turns off advanced command line editing. MODE NCLE is the default. Only the previous command is available for fetch, modification and re-execution. >.. (Default) Return to previous panel ~ . mocolumn FORMAT1: MODE COL[UMN] PUFPOSE: Turn on the display of the column header when entering LINE INPUT mode. Mode NCOLUMN is the default. FORMAT2: MODE NCOL[UMN] PURPOSE: This command causes the editor to halt the display of column headers when changing to input mode. NCOLUMN is the default. MODE INFO and MODE NINFO >.. (Default) Return to previous panel ~ . minfo FORMAT1: MODE INF[O] PURPOSE: Changes the transition from EDIT to LINE INPUT mode. When MODE INFO is active the entry of an empty (NULL) command line causes a the equivalent of a single line NEXT command. To enter LINE INPUT mode you must type an i immediately followed with a return. FORMAT2: MODE NI[NFO] When Mode NINFO (default) is active an empty (NULL) command line in EDIT mode forces a change to INPUT mode. >.. (Default) Return to previous panel ~ . mindent FORMAT1: MODE IND[ENT] PURPOSE: Turns ON MODE INDENT for SCREEN mode. When MODE INDENT is ON and INSERTing characters, an enter/return in SCREEN mode will split the line and indent the new line with the same beginning of line whitespace as the previous line. The cursor will be positioned to the first non-white space character. When MODE INDENT is ON and REPLACEing characters, an enter/return in SCREEN mode will position the cursor to the first non-whitespace character on the next line. Mode NINDENT is the default. FORMAT2: MODE NIND[ENT] PURPOSE: Turns OFF MODE INDENT for SCREEN mode. When MODE INDENT is OFF and INSERTing characters, an enter/return in SCREEN mode will split the line and position the cursor to the first column of the new line. When MODE INDENT is OFF and REPLACEing characters an enter/return in SCREEN mode will position the cursor to the beginning of the next line. Mode NINDENT is the default. >.. (Default) Return to previous panel ~ . mocount [PRINT] FORMAT1: MODE COU[NT] [start] [increment] [width] [BLANK] [SUPPRESS] PURPOSE: Set and turn on the COUNTE symbol counter. The APPEND, INSERT, OVERLAY, RETYPE, GMODIFY and CHANGE commands can reference the current value by use of the current COUNTE (default @) symbol. Each reference increments the counter. The optional PRINT, BLANK, and SUPPRESS deal with the counter and leading zeros. PRINT (default) displays leading zeros, BLANK replaces leading zeros with spaces, and SUPPRESS removes leading zeros. FORMAT2: MODE NCOU[NT] PURPOSE: Turns off the COUNTE symbol counter and releases the COUNTE symbol character for normal use. >.. (Default) Return to previous panel ~ . mprompt FORMAT1: MODE PRO[MPT] [edit_prompt] [input_prompt] PURPOSE: Change the prompt displayed when changing to/from INPUT and EDIT modes. The defaults for mode prompt are & for INPUT mode and the $ for EDIT mode. FORMAT2: MODE NP[ROMPT] PURPOSE: Forces the use of the default INPUT prompt for INPUT mode and EDIT prompt for EDIT mode. >.. (Default) Return to previous panel ~ . mnologo FORMAT: MODE NO[LOGO] PURPOSE: When found in any of the startup files (scanned before the logo is displayed) avoids the display of the I.S.T. logo. >.. (Default) Return to previous panel ~ . mstartup FORMAT: MODE STAR[TUP] [E[DIT]] or [I[NPUT]] or [S[CREEN]] PURPOSE: When found in any of the startup files it forces the requested mode at the beginning of the session. >.. (Default) Return to previous panel ~ . mshow FORMAT: MODE SH[OW] /xy/ PURPOSE: Sets the range of characters to display on screen. SysEdit has the ability to display all ASCII characters from octal ^000 to octal ^377. On some terminals this can have a negative effect. The MODE SHOW command provides a way to tell SysEdit the range of characters that can be displayed. Most displayable characters are from octal 40 to octal 176. (Thats space thru tilde). For that reason the default setting is: MODE SHOW /^40^176/ The range of characters from octal ^000 until the first (x) character value will display as a (tilde) in screen mode or in its octal representation in EDIT and LINE modes. (Except TAB characters when MODE TAB is set). The range of characters following the second (y) character value to octal ^377 will display as a (tilde) in full screen mode or in the octal representation in EDIT and line modes. MODE SHOW range can be changed at any time but is normally set in the ISTSE.terminal_type files used at startup. CAUTION: MODE SHOW can cause all characters to show as (tilde) if you do something dumb like: MODE SHOW /^001^002/ >.. (Default) Return to previous panel ~ . mstatus FORMAT1: MODE STAT[US] [-LINE] [-COL] PURPOSE: Turns on the display of the STATUS line in SCREEN mode. Full screen editing cursor movement and scrolling can become too slow on some terminals and while editing over communications lines. To speed interactive editing functions but leave other STATUS line information in place use the -LINE or -COL option. The -LINE option turns off the update of the STATUS line LINE and COLUMN numbers. The -COL option turns off the update of just the COLUMN numbers. If this is still not fast enough then use MODE NSTATUS. MODE STATUS is default. FORMAT2: MODE NS[TATUS] PURPOSE: This command turns off the SCREEN mode STATUS line. This is used to speed the display of data on slow terminals. >.. (Default) Return to previous panel ~ . mtab FORMAT1: MODE T[AB] PURPOSE: Turns on expansion of entered tab character to white space for display only. Any entered TABS will remain as TABS in the file. MODE TAB is the default. FORMAT2: MODE NT[AB] PURPOSE: Turns entered TABS into SPACE characters up to the next TAB stop. This is an advantage when working with columns of data in that "what you see is what you really have". >.. (Default) Return to previous panel ~ . mwrap FORMAT1: MODE W[RAP] PURPOSE: Turns on automatic wordwrap in SCREEN mode. Inserted characters that cause the current line to be greater than linesz will force all space separated words beyond linesz to the next line. If there is not room on the next line for the wrapped words a new line will be inserted to hold the text. When MODE WRAP is ON the DELETE_CHAR key function (used at the end of a line) will only join the number of words from the next line that there is room for. The MODE WRAP is tied to linesz. On most sites linesz defaults to 5096. To use MODE WRAP reset linesz to a more reasonable number like 80 or 132. FORMAT2: MODE NW[RAP] PURPOSE: Turns off automatic wordwrap in SCREEN mode. MODE NWRAP is the default. >.. (Default) Return to previous panel ~ . mov MOVE COMMAND FORMAT: MOVE n [F[ROM] x] [T[O] y] PURPOSE: Move n lines from line x to line y. Both x and y default to the current line. >.. (Default) Return to previous panel. ~ . m MODIFY COMMAND FORMAT1: M[ODIFY]/string-1/string-2/[g][n] FORMAT2: M[ODIFY]/string-1/string-2/[g][A] PURPOSE: Start with the current line and modify any string-1 occurrences to the value of string-2. If found String-1 is blanked then string-2 replaces string-1. If string-1 is the longer then there will be spaces following string-1 in the newly modified line. If string-2 is the longer it will overlay any text beyond the end of string-1. When g is included all occurrences of string-1 in each line will be modified. When number n (Format1) is used modify n lines starting at the current line. When A is used (Format2) modify all lines in the file then return to the original line. >.. (Default) Return to previous panel. ~ . n NEXT COMMAND FORMAT1: N[EXT] [n] FORMAT2: + [n] FORMAT3: - [n] PURPOSE: Change the line pointer + or - n lines from the current line. If n is positive then the line pointer will be modified by +n lines. If n is negative then the line pointer will be modified by -n lines. Default for n is 1. >.. (Default) Return to previous panel. ~ . ob OBJECT COMMAND General Purpose: Allows the definition, use, saving and reloading of named key stroke OBJECTS to speed entry of frequent, repetitive text. When the XEQ_OBJECT key function is pressed in SCREEN mode the previous text on the line is compared with the list of currently defined OBJECTS. If the previous text matches the OBJECT NAME the text is removed from the line and replaced with all key_values, key_functions, and text_strings bound to the defined OBJECT. FORMAT1: OB[JECT] PURPOSE: Displays all defined objects on the screen. FORMAT2: OB[JECT] "object name" [key_value]&|[key_function]&|["text_string"]... PURPOSE: Defines the OBJECT NAME and binds key_values, functions and text to to it. FORMAT3: OB[JECT] "object name" <PLAYBACK PURPOSE: Defines the OBJECT NAME and binds the current recorded keystroke macro to it. Also see the RECORDING and PLAYBACK key functions. FORMAT4: OB[JECT] L[OAD] filename PURPOSE: Loads a file of OBJECT definition commands. (FORMAT 2). FORMAT5: OB[JECT] S[AVE] [-A] filename PURPOSE: Saves all currently defined OBJECTS to the filename. If -A is used the currently defined OBJECTS are appended to the existing file. FORMAT6: OB[JECT] C[LEAR] PURPOSE: Clears all currently defined OBJECTS. >.. (Default) Return to previous panel. ~ . oo OOPS COMMAND FORMAT: OOps PURPOSE: When you change or delete a line in error OOPS lets you replace the changed line with the original. Oops will only work on single line changes. Also OOPS requires you to still be at the same line number in the file that was last changed. If the user is not at the same line number or the last change was part of a multi-line command the 'BAD OOPs' message will inform you that it's too late to save your data from what you've done to it. >.. (Default) Return to previous panel. ~ . o OVERLAY COMMAND FORMAT: O[VERLAY] string PURPOSE: Use a string as a mask to OVERLAY an existing line. The string can contains spaces, '!', and other characters. The Overlay command must have one space preceding the string mask. Any spaces in the string mask cause the corresponding character in the original line to be copied to the modified line. Any ! characters found in the string mask force a space into the modified line and the corresponding original character is ignored. If one or more TAB characters are present in the string mask they will force duplication of the original line up to the next TAB stop column. Any other characters in the string mask replace the characters from the original line. >.. (Default) Return to previous panel ~ . pa PAGESZ COMMAND FORMAT: PAGESZ [-]n PURPOSE: Set the number of lines to move with the PGUP and PGDN key functions. COMMENT: This command can be used to vary the number of lines up or down the file when the CRSR_PGUP and CRSR_PGDN key functions are pressed. If the number n is positive then n becomes the length of the page. If the number n is negative then the number of lines in the current window minus n becomes the length of the page. >.. (Default) Return to previous panel ~ . po POINT COMMAND FORMAT1: PO[INT]n FORMAT2: n PURPOSE: Position to line number n immediately. >.. (Default) Return to previous panel ~ . pp PRINT IN POSITION COMMAND FORMAT: PP[RINT][-n] [m] PURPOSE: Display lines near by the current line without moving. Lines will be displayed from the current line -n lines and will continue to display until current line +m lines. Defaults for n and m are zero. When both are zero or left out defaults become -5 and 5. >.. (Default) Return to previous panel ~ . ps PRINT SYMBOLS COMMAND FORMAT: PS[YMBOL] PURPOSE: Display the current values assigned to the character symbols. It will show the KILL, ERASE, WILD, BLANKS, TAB, ESCAPE, COUNTE, and SEMICO symbol values. >.. (Default) Return to previous panel ~ . p PRINT COMMAND FORMAT: P[RINT][n] PURPOSE: Display n lines starting at the current line and make the last line displayed the current line. n must be a positive number. n defaults to 1. >.. (Default) Return to previous panel ~ . que QUERY COMMAND FORMAT1: ? [command_name] PURPOSE: Query User to build and execute a command. The QUERY command helps the user build EDIT mode commands by asking questions. No knowledge of the Command format or options is required to create valid powerful commands. Change FILe Find Locate Modify Next POint SAVe command_names are all supported by the query command. The upper case letters in the command names represent the shortest abbreviation that can be used with the QUERY command. When responding to the questions asked by query the default answer is surrounded by parens and is selected with the END_LINE (RETURN) key function. The ABORT (cntl_c) key will abort the QUERY command without executing the command created. EXAMPLE: ? locate Locate [P]revious or (N)ext -> P Case Insensitive? [Y] or (N) -> String to locate -> R. Jones 241: 0089379993E R. Jones 1983 Washegan Drive. >.. (Default) Return to previous panel. ~ . q QUIT COMMAND FORMAT1: Q[UIT] FORMAT2: QF[ORGET] PURPOSE: End the current session quickly. The QUIT command provides a quick exit from a SysEdit session. If the file has been modified the user will be asked if it is O.K. to quit. If the response is 'Y' or 'YES' the user will be returned to the operating system, otherwise all will be left as it was. Users wanting to avoid the question can type 'QF' to quit and forget any changes that might have been made. >.. (Default) Return to previous panel. ~ . r RETYPE COMMAND FORMAT1: R[ETYPE] PURPOSE: Interactivly Retype and replace the current line. This command allows reentry of the current line in the file. Format 1 of the RETYPE command is not followed by a replacement text string. It instead, provides an interactive retyping of the text line. The user can modify the current line by copying, ignoring, and inserting new text. Duplication of characters is done with the key assigned to crsr_right. Skipping over source line characters is done with the key assigned to delete_char. To insert new text press the key assigned to insert_toggle. When del or right arrow are pressed the insert mode ends. A RETURN or END_LINE ends the line and completes the replacement. FORMAT2: R[ETYPE] text... PURPOSE: Replace the current line with the text. >.. (Default) Return to previous panel. ~ . sa SAVE COMMAND PURPOSE: Save the current file buffer to disk. FORMAT: SA[VE] [-A] [filename] If filename is not supplied the current file name will be used as the default filename. If this is a new file then the user will be asked for a valid filename. If the filename is supplied and the optional -A is used the file in memory will be appended to the existing text in the filename. >.. (Default) Return to previous panel. ~ . se SEARCH COMMAND FORMAT: SE[ARCH] [P[REV]] [C][N][(col)]/string1/ [&][|] [[C][N][(col)]/string1/] ... PURPOSE: Search for the next line with multiple arguments. The SEARCH command allows complex searching of the file. The advantage of the SEARCH over the LOCATE and FIND commands it that it can scan for lines with up to 9 different strings. Each individual string specified is optionally case insensitive, optionally located in a specific column, or excluded from the line. Each string to be searched for has several optional parameters in front of it. The optional C specifies case insensitivity. The optional N specifies searching for a line that does not contain the string. The optional (col) specifies the column the string must be in. The string must be preceded by and followed by a delimeter character. The delimeter character can be any character except c, n, ! and (. EXAMPLES Search for the next line containing the string kite. se /kite/ Search for the next line containing the strings kite and beach se /kite/ & /beach/ Search for the previous line without kite but with beach se p n/kite/ & /beach/ Search for the next line without kite in col 10 se n(10)/kite/ Search for the next line with kite and case insensitive cron but not case insensitive cronkite se /kite/ & c/cron/ & cn/cronkite/ >.. (Default) Return to previous panel. ~ . sh SHELL COMMAND FORMAT: SH[ELL] shell_command_string PURPOSE: To execute an external operating system command without ending the SysEdit session. Any valid operating system command can be entered as the shell_command_string. >.. (Default) Return to previous panel. ~ . s SYMBOL COMMAND FORMAT: S[YMBOL] symbol-name character PURPOSE: Change one of the current characters associated with a symbol to another character. Kill ERase Wild Blanks Tab EScape COunte SEmico Just type "SYMBOL KILL ?" to change the current KILL character to a question mark. >.. (Default) Return to previous panel. ~ . ta TABSET COMMAND FORMAT: TA[BSET] n1 n2 n3 n4 ... PURPOSE: Set the current TAB stop columns to the ascending numbers n1 n2 n3 n4 etc. Up to 256 tabs can be set. When MODE NTAB is active and a SysEdit user presses the TAB key the cursor will move to the next tab stop column and insert spaces into the line. When MODE TAB is active and a SysEdit user presses the TAB key a real TAB character will be placed into the line. In LINE and EDIT modes this will appear as an ^011 character. In SCREEN mode this will be seen as white space and will move the cursor to the right. >.. (Default) Return to previous panel. ~ . t TOP COMMAND FORMAT: T[OP] PURPOSE: Set the current line pointer to line 0. It is a .null. line before the first data line in the file. >.. (Default) Return to previous panel. ~ . u UNLOAD COMMAND FORMAT1: UN[LOAD] [-A] filename n PURPOSE: Unload n lines starting at the current line and place them into the filename provided. No lines are deleted from the work file. If the optional -A is included the selected text is appended to the existing text in the file. FORMAT2: UN[LOAD] [-A] filename TO string PURPOSE: Unload all lines starting at the current line until a line is found containing the string. The line with the string is not unloaded. If the optional -A is included the selected text is appended to the existing text in the file. >.. (Default) Return to previous panel. ~ . v VERIFY COMMAND FORMAT: V[ERIFY] PURPOSE: Return SysEdit to the default print mode after a BRIEF command. >.. (Default) Return to previous panel. ~ . w WHERE COMMAND FORMAT: W[HERE] PURPOSE: Display the current line number. >.. (Default) Return to previous panel. ~ . x XEQ COMMAND FORMAT1: X[EQ] [filename] PURPOSE: Execute the requested file of EDIT mode commands. FORMAT2: X[EQ] PURPOSE: Re-execute the last EDIT mode command. >.. (Default) Return to previous panel. ~ . /* EDIT MODE COMMENT LINE FORMAT: /* [optional descriptive text] PURPOSE: Allow the addition of comments in the LOG and in external command files used by XEQ. When a /* is found on a command line the rest of the command line is ignored. >.. (Default) Return to previous panel. ~ . * REPEAT COMMAND FORMAT: *[n] PURPOSE: This command is never used alone. It is always used after some other EDIT mode command followed by a command separator character. (;) It forces the previous commands on the current command line to be repeated n times. If n is not present then only TOP, BOTTOM of the file or a CNTL_C (ABORT) will stop the repetitions. Warning: Users can create commands that repeat forever. Unless you want to grow old while waiting for command completion be CAREFULL when using repeat. Here is an example of a command line with nested repeat commands. Locate dog;Change/dog/cat/;*3;Locate wolf;* This command will locate the next line with dog in it and change the string dog to cat. It will repeat that three times and then locate the next line in the file with the string wolf. It will then repeat those steps until the bottom of the file is reached. >.. (Default) Return to previous panel. ~ . end-of-file ~